home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / bulchk20.zip / BULLCHK.DOC < prev    next >
Text File  |  1994-05-25  |  11KB  |  234 lines
  1.  *************************************************************************
  2.  *                            BULLCHK.PPE                                *
  3.  *                   A PCBoard 15 Sysop Utility PPE                      *
  4.  *                   version: 2.0   date: 05/25/1994                     *
  5.  *                    (c) Copyright 1994  A. Segura                      *
  6.  *************************************************************************
  7.          Compiled in PPLC ver. 2.0 for PCBoard ver. 15.1
  8.  
  9.  
  10. PURPOSE
  11. The purpose of this PPE is to allow automatic monitoring of bulletins
  12. read by users and to perform an automatic upgrade of the user when the
  13. monitored bulletins have all been read.  (I.E.  such as monitoring for
  14. when a new user has read all the system rules and disclaimer bulletins).
  15.  
  16.  
  17. USAGE
  18. The Bulletin Read Checker (BULLCHK) PPE program is executed by placing
  19. a call to the program, along with bulletin sequence #, on the last line of a
  20. bulletin desired for monitoring.  For example, say you wanted your
  21. 'Bulletin #1--Board Rules' to be the first monitored bulletin--on the
  22. last line of the bulletin, first column, enter:  !C:\PCB\PPE\BULLCHK.PPE 1
  23. Don't forget the ! symbol, it tells PCBoard to execute the PPE--also
  24. include the path--and don't forget the last entry of the bulletin sequence
  25. number.  This number would be changed to 2 in the second monitored
  26. bulletin--and to 3 in the third monitored bulletin, etc.  Also, MKPCBTXT.EXE
  27. must be utilized to clear Record #2 question prompt (What CPU are you using)
  28. so as to deactivate User Comment field #1 from the user.  The user comment
  29. field is used as a counter register by the PPE.
  30.  
  31.  
  32. ZIP
  33. CONTENTS:
  34.    1.   BULLCHK.DOC  this file.
  35.    2.   BULLCHK.PPE  the subject PPE file (see description above).
  36.    3.   BULLCHK.CFG  the PPE config file.
  37.    4.   ALLBULL.TXT  text display message file
  38.    5.   FILE_ID.DIZ  a brief BBS text description of this item.
  39.  
  40.  
  41. CFG File:    The configuration file (BULLCHK.CFG) contains 7 line entry
  42.              values which can be modified by the sysop per his/her needs
  43.              (see sample file).
  44.  
  45.  
  46.                                                         Sample values
  47.      ------------------------------------               -------------
  48.      Line 1: checked user level #1                           5
  49.      Line 2: checked user level #2                          10
  50.      Line 3: upgrade level #1                               14
  51.      Line 4: upgrade level #2                               15
  52.      Line 5: extra days for upgrade level #1                30
  53.      Line 6: extra days for upgrade level #2                60
  54.      Line 7: number of bulletins to monitor                  5
  55.  
  56.         The Line 1 and 2 values are current user levels for
  57.         monitoring two different levels of users for upgrading
  58.         to two other levels (lines 3 and 4).  You can uses these
  59.         to whatever your desire (see example CFG above).  If you
  60.         only want to monitor for one level only, then make the
  61.         level #1 values (lines 1 and 3) 0.  Once a user has been
  62.         upgraded, the PPE will terminate for users at or above the
  63.         upgrade levels.
  64.  
  65.         The 5th and 6th entries are a number value representing how
  66.         many extra days to add to the user's account upon reading
  67.         all the monitored bulletins (ie: 0 or 10 or 30 or 60, etc).
  68.  
  69.         Line 7 value is the number of bulletins you desire to monitor.
  70.  
  71.  
  72.  
  73. PPE execution notes:
  74.  
  75.  
  76.         The PPE stores the bulletin read information in user comment
  77.         field #1 as follows:  bulletin #1 represented by 1, bulletin
  78.         number 2 represented by 2, bulletin #3 represented by 4, etc.
  79.         Therefore, when all three bulletins have been read by a user
  80.         a 7 will be saved in the field.
  81.  
  82.         File 'ALLBULL.TXT' is a sysop editable display file which is
  83.         displayed to the user when he has read all monitored bulletins
  84.         and is being automatically upgraded.  The file must be in same
  85.         directory as PPE file. If file cannot be found the message
  86.         'Could not find ALL_Bulletin Read file (BULLCHK. PPE)!' will
  87.         be written to the caller log.
  88.  
  89.         If no number was entered in the bulletin after the PPE call, a
  90.         message 'Did not detect a command-line bulletin #' (BULLCHK.PPE)!'
  91.         will be written to the caller log.
  92.  
  93.         If for some reason you entered a bulletin callout number greater
  94.         than 10 a message '.Bulletin # invalid (BULLCHK. PPE)!' will be
  95.         written to the caller log.
  96.  
  97.  
  98. UPDATES:
  99. The latest version of the PPE program can be obtained from my BBS:
  100. SBG Online! BBS (703) 450-9456.  If you have any comments or suggestions
  101. for improvement, you can leave them there also.  The file will be found
  102. in directory #1 as a FREE/NOTIME file.  The BBS runs PCBoard 15 at
  103. 28800v32bis.  You can also reach me via RIME (Sysop or PCB Util conf.)
  104. at routing SBGONLINE (#5561).
  105.  
  106.  
  107.  
  108. Registration:   NONE!!  There is no registration fee.  Basic use of the PPE
  109.                 is FREE!!!
  110.  
  111.                 However, if you feel compelled that my work is worth
  112.                 compensation, I will accept all offers.  Thank You!
  113.  
  114.                 Also, if you would like to provide suggestions for
  115.                 improvement to the PPE, bug reports, or just a note
  116.                 of thanks or hello, please forward those as well.  See
  117.                 below for my mailing address and BBS number. Additionally,
  118.                 I frequently browse the RIME Sysop and PCBoard conferences,
  119.                 although contacting me there is not as reliable because
  120.                 sometimes I get too busy to call.
  121.  
  122.  
  123. Source          If you desire a diskette containing the PPL source code so
  124. Code:           you can modify it for your own use, the cost is $15 US.  I
  125.                 accept cash, money order, VISA or Mastercard. You can place
  126.                 an order online on the BBS (703) 450-9456 or by mail at:
  127.                 A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  128.  
  129.                 EXTRA, EXTRA!! In addition to the BULLCHK source, you
  130.                 will also receive source to a "Last TEN Caller" and
  131.                 "Running Log Caller" bulletin generators that I have
  132.                 developed as well.
  133.  
  134.                 As another option, for $25, you can subscribe to the PPE
  135.                 conference on my BBS.  The conference will always contain
  136.                 the latest versions of all the source code for BULLCHK,
  137.                 CALLBLOC, DUP-BLOC, CALLERID, VULGARID and several other
  138.                 PPEs for immediate downloading.  The subscription period
  139.                 lasts one year.  We also have the latest version of the
  140.                 PIER Shareware CDROM always online.  You can even subscribe
  141.                 online with your VISA/MC via (S)cript Questionaire #2 for
  142.                 immediate access.
  143.  
  144.  
  145. Distribution:   You may freely distribute this complete package only in an
  146.                 unmodified form.  No remuneration may be collected or charged
  147.                 for this work by anyone other than the below noticed
  148.                 individual/company except for that cost incurred in actual
  149.                 electronic media production (i.e. diskette or CDROM).  In
  150.                 other words, it can be placed on BBSs, shareware CDROMS, etc.
  151.                 but I/my company reserves the right of copyright and
  152.                 remuneration for the actual work.  The source code MAY NOT
  153.                 be distributed by anyone other than the below listed company.
  154.  
  155.  
  156. Disclaimer:     The user agrees when utilizing this package that he does so
  157.                 at his own risk with no guarantees, implied or otherwise, as
  158.                 to the functional performance or liability of the package.
  159.  
  160.  
  161. Development
  162. History:        ver.   date       remarks
  163.                 ----   --------   ---------------------------------------
  164.                 1.0    12/01/93   Initial release.
  165.                 1.1-2  12/11/93   Bug fixes.
  166.                 1.3    01/01/94   Multi-option release.
  167.                 2.0    05/25/94   Totally revised, more options.
  168.  
  169.  
  170. ***************************************************************************
  171. *                    (c) Copyright 1994  A. Segura                        *
  172. ***************************************************************************
  173.  
  174.  
  175.  
  176.  ********************************************************************
  177.  *      Look for these other fine utilities at a BBS near you       *
  178.  ********************************************************************
  179.  
  180.  AUTOSUBS.PPE   run as a script questionnaire, allows online credit
  181.                 card subscriptions to BBS (VISA/MC), completes log
  182.                 entries and sends alert message to SysOp. (for
  183.                 PCBoard 15)
  184.  
  185.  ALLCALL.PPE    generates a text display bulletin, complete with PCB
  186.                 color codes, of all the callers to the board.
  187.  
  188.  ALLSTAT.PPE    generates a text display bulletin, complete with PCB
  189.                 color codes, of statistics of all the callers to the board.
  190.  
  191.  CALLERID.PPE   performs basic callerid identification, logs info
  192.                 in file log and user records if desired, and will
  193.                 also display desired text screens to users--must
  194.                 have callerid capable modem.  Several SysOp config-
  195.                 uable options. (for PCBoard 15)
  196.  
  197.  CALLBLOC.PPE   performs a call blocking function before the
  198.                 user can log on based upon a SysOp defined listing
  199.                 of undesirable phone numbers--must have callerid
  200.                 capable modem. Even sends the SysOp an alert message.
  201.                 (for PCBoard 15)
  202.  
  203.  DUP-BLOC.PPE   Blocks current users from signing-on with duplicate
  204.                 records--uses CallerID info.  Should be used with
  205.                 CALLBLOC.PPE for complete blocking system.
  206.  
  207.  MAKEBLTN.EXE   Top callers, cities, down/uploaders bulletin generator.
  208.  
  209.  PADLOADS.EXE   Automated uploads directory padder--makes your BBS look
  210.                 more active with more daily uploads.
  211.  
  212.  REPORT.EXE     Program generates reports of CallerID info, user record
  213.                 phone numbers, common passwords and several other goodies
  214.                 to aid Sysop in identifying abusive or questionable users.
  215.  
  216.  VULGAR.PPE     performs a vulgar word/phrase check on user names and
  217.                 city entries based on a file of names defined by
  218.                 SysOp, and performed before complete newuser login.
  219.                 (for PCBoard 15)
  220.  
  221.  VULGARID.PPE   same program as VULGAR.PPE except it automatically
  222.                 passes the callerid info to CALLBLOC.PPE program
  223.                 for future lock-outs. (must have both programs and a
  224.                 modem that supports callerid) (for PCBoard 15)
  225.  
  226.                 NOTE: VULGARID ver. 1.x only works with CALLBLOC
  227.                       ver. 1.x.  VULGARID ver. 2.x only works
  228.                       with CALLBLOC ver. 2.x.
  229.  
  230. ***************************************************************************
  231. *        (c) Copyright 1993  A. Segura/Fax~An~Ad Marketing, Inc.          *
  232. ***************************************************************************
  233.  
  234.